home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr33 / xecute10.zip / XEC.DOC < prev    next >
Text File  |  1993-05-01  |  7KB  |  180 lines
  1.         
  2.         
  3.         
  4.                     XECUTIONER   Version 1.0,   1 MAY 93
  5.  
  6.                                - Written by -
  7.                                Garry W. Elmer
  8.                                    K-9 BBS
  9.                              CANDYNET 42:1019/1
  10.                                1-203-536-1300
  11.         
  12.                                 ***********             
  13.         
  14.                          $$$  HOW MUCH IS IT????  $$$
  15.         
  16.         If you are using this software in a non-organizational 
  17.         environment, it is yours to use as you see fit.  If you are 
  18.         using this program as part of any organization such as 
  19.         corporate, government, or business related, the program is 
  20.         $20.00.  That is only fair.
  21.  
  22.         Send Check or Moneyorder to:
  23.  
  24.         Garry W. Elmer
  25.         63 Clift St.
  26.         Mystic, CT
  27.         06355
  28.  
  29.         If you have ideas or require modifications to the program 
  30.         to better meet your needs, please contact me via my BBS 
  31.         (listed above).
  32.  
  33.                                    WARRANTY 
  34.  
  35.         Every effort was taken to ensure a quality program.  However, 
  36.         because of the there's no way to anticipate all the different 
  37.         ways this program can, or will be used, or on what equipment 
  38.         it may be used, I make no guarantees or warranties of any 
  39.         kind, nor will I hold responsibility for any type of damage 
  40.         caused by this program.  
  41.         
  42.                              As always: BACK UP!
  43.         
  44.                                    OVERVIEW
  45.         
  46.         XECUTIONER was originally written to monitor the creation 
  47.         of data files on a mainframe, via ETHERNET, and 
  48.         automatically move the files down to a PC for modification 
  49.         then return them to the mainframe for further action.  It 
  50.         was executed in a DOS window under WINDOWS and allowed the 
  51.         PC to be used for other things while waiting to service the 
  52.         mainframe. 
  53.         
  54.         XECUTIONER is a simple little program designed to meet a 
  55.         variety of requirements.  Basically, XECUTIONER will look 
  56.         in a designated directory for creation of a specified file 
  57.         or group of files.  Upon finding a file meeting the 
  58.         designated criteria, XECUTIONER will execute various 
  59.         commands or spawn selected programs, then return to a 
  60.         search condition.
  61.  
  62.         XECUTIONER can run in the "background" under WINDOWS or 
  63.         DESQVIEW and monitor network volumes or the output of other 
  64.         programs running in other "windows" and take care of just 
  65.         about any task you could want.
  66.  
  67.         CONFIGURING XECUTIONER
  68.  
  69.         The XECCFG.EXE program creates the XEC.CFG program used by 
  70.         XECUTIONER.
  71.  
  72.         Selections:
  73.  
  74.         DETECT DELAY (In Seconds): 
  75.         
  76.         This is the search delay, in seconds, for how often 
  77.         XECUTIONER will check for the target file.  Can be just 
  78.         about any length from 1 second on up.  Can be varied to 
  79.         keep network "overhead" to a minimum.
  80.  
  81.         ENABLE DELAY (In Seconds):
  82.  
  83.         This is the delay, in seconds, from time of detect until 
  84.         the user selected commandlines are executed.  Since 
  85.         XECUTIONER ignores file sharing and such, this delay should 
  86.         be set liberally to allow for the file to be created 
  87.         completely before the user commandlines are executed.
  88.  
  89.         TARGET DIRECTORY:
  90.  
  91.         Complete path to the directory where the TARGET file(s) are 
  92.         to be found.  
  93.  
  94.         EXAMPLE:  "C:\DATA"
  95.  
  96.         TARGET FILE:
  97.  
  98.         File name of the file that is going to trigger XECTIONER.  
  99.         WILDCARDS can be used.
  100.  
  101.         EXAMPLE:
  102.         TEST.DAT
  103.         *.DAT
  104.         SAMPLE.*
  105.  
  106.         If the TARGET DIRECTORY is "C:\DATA" and TARGET FILE is 
  107.         "SAMPLE.DAT", XECUTIONER will trigger on the creation of 
  108.         "C:\DATA\SAMPLE.DAT".  If the TARGET file was "*.DAT" 
  109.         the creation of any file with the extension "DAT" would 
  110.         trigger XECUTIONER.  
  111.  
  112.         DOS COMMANDLINEs 1,2,3,4  and ENABLE COMMANDLINE.
  113.  
  114.         These commandlines will be executed in the order shown in 
  115.         the configuration program.  If a SPACE is entered for the 
  116.         first character in the commandline, the line will be 
  117.         deleted and ignored.
  118.  
  119.         DOS COMMANDLINE-
  120.         Each of these 4 lines can contain any DOS command, such 
  121.         as DEL, COPY, or path and name of a batch file such as 
  122.         "C:\TEST\ACTION.BAT".  Things like "COPY C:\TEST\*.DAT 
  123.         Z:\" can be used, etc.
  124.  
  125.         ENABLE COMMANDLINE-
  126.         This line of for the spawning of a program.  The DOS 
  127.         commandlines can only call DOS commands or execute batch 
  128.         files.  This line can execute any program and should 
  129.         contain the complete path to the program and any 
  130.         commandline switches required.
  131.  
  132.         COMMANDLINE Variables %1, %2, and %3.
  133.  
  134.         These variables are created by XECUTIONER and can be 
  135.         added to either the DOS or ENABLE COMMANDLINES. 
  136.         
  137.         %1 = TARGET DIRECTORY PATH   Ex. "C:\TEST"
  138.         %2 = TARGET FILE NAME        Ex. "SAMPLE.DAT"
  139.         %3 = TARGET PATH & FILE NAME Ex. "C:\TEST\SAMPLE.DAT"
  140.  
  141.         NOTE: If a WILDCARD is used in the TARGET FILE NAME, the 
  142.         name of the file actually found will be passed in %2 and 
  143.         %3.
  144.         
  145.         Example:
  146.         
  147.         TARGET FILE NAME - "*.DAT"
  148.         File created - "NUMERIC.DAT"
  149.         %2 would be "NUMERIC.DAT".
  150.  
  151.         Example:
  152.         
  153.         ENABLE COMMANDLINE - "C:\DATA\TEST.EXE %2"
  154.         Executed- C:\DATA\TEST.EXE NUMERIC.DAT
  155.  
  156.         DOS COMMANDLINE - "COPY C:\DATA\%2 Z:\"
  157.         Executed- "COPY C:\DATA\NUMERIC.DAT Z:\"
  158.  
  159.         Note:  The variables %1, %2, and %3 will not be passed 
  160.         INSIDE of a batch file call from a DOS COMMANDLINE.
  161.  
  162.         The COMMANDLINE Variables displayed at the bottom of the 
  163.         XECCONFIG program window are the updated as the TARGET 
  164.         PATH and TARGET FILE selections are changed.
  165.  
  166.         F1 will cause the configuration to be saved and ESC will 
  167.         cause the program to be exited without change.
  168.  
  169.         XEC.EXE -
  170.  
  171.         Once the configuration, XEC.CFG has been created, XEC.EXE 
  172.         can be run.  The XEC.CFG must be in the same directory as 
  173.         XEC.EXE.  XEC.EXE may be executed from a DOS window under 
  174.         WINDOWS, a DESQVIEW window, or from the DOS prompt.  The 
  175.         program itself takes up under 30K of RAM.  The program 
  176.         gives a simple display and can be terminated with the ESC 
  177.         key.  XECUTIONER will not terminate after a commandline 
  178.         sequence but will recycle and wait for the next 
  179.         commandline sequence.
  180.